AGENTDECK · DESIGN AUDIT · v0.1

Are we consistent?

Three layers of checks: an automated lint, a coverage matrix, and a side-by-side visual parity. Run the bash lint locally for the freshest numbers; this page is a living snapshot.

SOURCE DESIGN.md v0.1

RUNNER design/lint.sh

SNAPSHOT 2026-05-09

01 · HOW TO RUN

Lint locally.

The bash script grep's the codebase for 8 rules derived directly from DESIGN.md §10 ("Don'ts") and prints file·line citations. Wire it into pre-commit or CI; exit code = violation count.

bash design/lint.sh

bash design/lint.sh --json > audit.json

02 · LINT RULES

Eight automatic checks.

Each rule maps to a clause in DESIGN.md. Token-defining files (design/tokens.css, site.css, data.js, creatures.jsx) are exempt — they are the source of truth.

No pure black/whiteForbid #fff / #000. Use --tide-50 / --ink-900.

No hardcoded hexAll colors via tokens. Hex outside token files is a leak.

No forbidden typefacesInter, Roboto, Arial, Fraunces and Helvetica Neue are out. Plex + JetBrains only.

Only amber pulseskelp / coral may not animate. They are static signals.

Warm shadows onlyNo pure-grey rgba(0,0,0,…) shadows. Use --sh-*.

No emoji in UIUse the icon set or creature marks. Emoji is for chat, not chrome.

Radius scaleborder-radius ∈ {0, 4, 8, 10, 12, 14, 16, 18, 999}. Anything else is a leak.

Palette separationMarketing surfaces (option-*-site, index.html) must not use product UI --ui-* tokens.

03 · COVERAGE MATRIX

Definition ⊂ Implementation ⊂ Display ⊂ Use.

Every component should travel down the chain: defined in DESIGN.md → implemented in components.css → shown in Design System.html → used by at least one page. A break in the chain = dead token, lonely token, or undocumented pattern.

Healthy

—

defined → used somewhere

Lonely

—

defined, never used

Dead

—

used but undocumented

Total

—

tracked components

Component	DESIGN.md	CSS	Display	Used in	Status

04 · VISUAL PARITY

The pages, side by side.

All HTML deliverables at the same scale. Toggle the 8px overlay to spot off-grid spacing; click the title to open a page full size.

05 · MANUAL FINDINGS

Things lint can't see.

Hand-curated observations the script can't catch — voice, hierarchy, and unused capabilities. Update this list whenever a finding is resolved or a new one appears.